home *** CD-ROM | disk | FTP | other *** search
open in: 
MacOS 8.1
|
Win98
|
DOS
view JSON data
|
view as text
This file was processed as: LaTeX Document
(document/latex).
You can browse this item here: libtime.tex
| Confidence | Program | Detection | Match Type | Support
|
|---|
| 100%
| dexvert
| LaTeX Document (document/latex)
| magic
| Supported |
| 1%
| dexvert
| Text File (text/txt)
| fallback
| Supported |
| 100%
| file
| LaTeX document text
| default
| |
| 99%
| file
| LaTeX document, ASCII text, with CR line terminators
| default
| |
| 100%
| checkBytes
| Printable ASCII
| default
| |
| 100%
| perlTextCheck
| Likely Text (Perl)
| default
| |
| 100%
| siegfried
| fmt/281 LaTeX (Subdocument)
| default
| |
| 100%
| detectItEasy
| Format: plain text[CR]
| default (weak)
|
|
| id metadata |
|---|
| key | value |
|---|
| macFileType | [TEXT] |
| macFileCreator | [R*ch] |
hex view+--------+-------------------------+-------------------------+--------+--------+
|00000000| 5c 73 65 63 74 69 6f 6e | 7b 42 75 69 6c 74 2d 69 |\section|{Built-i|
|00000010| 6e 20 4d 6f 64 75 6c 65 | 20 5c 73 65 63 74 63 6f |n Module| \sectco|
|00000020| 64 65 7b 74 69 6d 65 7d | 7d 0d 0d 5c 62 69 6d 6f |de{time}|}..\bimo|
|00000030| 64 69 6e 64 65 78 7b 74 | 69 6d 65 7d 0d 54 68 69 |dindex{t|ime}.Thi|
|00000040| 73 20 6d 6f 64 75 6c 65 | 20 70 72 6f 76 69 64 65 |s module| provide|
|00000050| 73 20 76 61 72 69 6f 75 | 73 20 74 69 6d 65 2d 72 |s variou|s time-r|
|00000060| 65 6c 61 74 65 64 20 66 | 75 6e 63 74 69 6f 6e 73 |elated f|unctions|
|00000070| 2e 0d 49 74 20 69 73 20 | 61 6c 77 61 79 73 20 61 |..It is |always a|
|00000080| 76 61 69 6c 61 62 6c 65 | 2e 0d 0d 41 6e 20 65 78 |vailable|...An ex|
|00000090| 70 6c 61 6e 61 74 69 6f | 6e 20 6f 66 20 73 6f 6d |planatio|n of som|
|000000a0| 65 20 74 65 72 6d 69 6e | 6f 6c 6f 67 79 20 61 6e |e termin|ology an|
|000000b0| 64 20 63 6f 6e 76 65 6e | 74 69 6f 6e 73 20 69 73 |d conven|tions is|
|000000c0| 20 69 6e 20 6f 72 64 65 | 72 2e 0d 0d 5c 62 65 67 | in orde|r...\beg|
|000000d0| 69 6e 7b 69 74 65 6d 69 | 7a 65 7d 0d 0d 5c 69 74 |in{itemi|ze}..\it|
|000000e0| 65 6d 0d 54 68 65 20 60 | 60 65 70 6f 63 68 27 27 |em.The `|`epoch''|
|000000f0| 20 69 73 20 74 68 65 20 | 70 6f 69 6e 74 20 77 68 | is the |point wh|
|00000100| 65 72 65 20 74 68 65 20 | 74 69 6d 65 20 73 74 61 |ere the |time sta|
|00000110| 72 74 73 2e 20 20 4f 6e | 20 4a 61 6e 75 61 72 79 |rts. On| January|
|00000120| 20 31 73 74 20 6f 66 20 | 74 68 61 74 0d 79 65 61 | 1st of |that.yea|
|00000130| 72 2c 20 61 74 20 30 20 | 68 6f 75 72 73 2c 20 74 |r, at 0 |hours, t|
|00000140| 68 65 20 60 60 74 69 6d | 65 20 73 69 6e 63 65 20 |he ``tim|e since |
|00000150| 74 68 65 20 65 70 6f 63 | 68 27 27 20 69 73 20 7a |the epoc|h'' is z|
|00000160| 65 72 6f 2e 20 20 46 6f | 72 20 55 4e 49 58 2c 20 |ero. Fo|r UNIX, |
|00000170| 74 68 65 0d 65 70 6f 63 | 68 20 69 73 20 31 39 37 |the.epoc|h is 197|
|00000180| 30 2e 20 20 54 6f 20 66 | 69 6e 64 20 6f 75 74 20 |0. To f|ind out |
|00000190| 77 68 61 74 20 74 68 65 | 20 65 70 6f 63 68 20 69 |what the| epoch i|
|000001a0| 73 2c 20 6c 6f 6f 6b 20 | 61 74 20 74 68 65 20 66 |s, look |at the f|
|000001b0| 69 72 73 74 0d 65 6c 65 | 6d 65 6e 74 20 6f 66 20 |irst.ele|ment of |
|000001c0| 5c 63 6f 64 65 7b 67 6d | 74 69 6d 65 28 30 29 7d |\code{gm|time(0)}|
|000001d0| 2e 0d 0d 5c 69 74 65 6d | 0d 55 54 43 20 69 73 20 |...\item|.UTC is |
|000001e0| 43 6f 6f 72 64 69 6e 61 | 74 65 64 20 55 6e 69 76 |Coordina|ted Univ|
|000001f0| 65 72 73 61 6c 20 54 69 | 6d 65 20 28 66 6f 72 6d |ersal Ti|me (form|
|00000200| 65 72 6c 79 20 6b 6e 6f | 77 6e 20 61 73 20 47 72 |erly kno|wn as Gr|
|00000210| 65 65 6e 77 69 63 68 20 | 4d 65 61 6e 0d 54 69 6d |eenwich |Mean.Tim|
|00000220| 65 29 2e 20 20 54 68 65 | 20 61 63 72 6f 6e 79 6d |e). The| acronym|
|00000230| 20 55 54 43 20 69 73 20 | 6e 6f 74 20 61 20 6d 69 | UTC is |not a mi|
|00000240| 73 74 61 6b 65 20 62 75 | 74 20 61 20 63 6f 6d 70 |stake bu|t a comp|
|00000250| 72 6f 6d 69 73 65 20 62 | 65 74 77 65 65 6e 0d 45 |romise b|etween.E|
|00000260| 6e 67 6c 69 73 68 20 61 | 6e 64 20 46 72 65 6e 63 |nglish a|nd Frenc|
|00000270| 68 2e 0d 0d 5c 69 74 65 | 6d 0d 44 53 54 20 69 73 |h...\ite|m.DST is|
|00000280| 20 44 61 79 6c 69 67 68 | 74 20 53 61 76 69 6e 67 | Dayligh|t Saving|
|00000290| 20 54 69 6d 65 2c 20 61 | 6e 20 61 64 6a 75 73 74 | Time, a|n adjust|
|000002a0| 6d 65 6e 74 20 6f 66 20 | 74 68 65 20 74 69 6d 65 |ment of |the time|
|000002b0| 7a 6f 6e 65 20 62 79 0d | 28 75 73 75 61 6c 6c 79 |zone by.|(usually|
|000002c0| 29 20 6f 6e 65 20 68 6f | 75 72 20 64 75 72 69 6e |) one ho|ur durin|
|000002d0| 67 20 70 61 72 74 20 6f | 66 20 74 68 65 20 79 65 |g part o|f the ye|
|000002e0| 61 72 2e 20 20 44 53 54 | 20 72 75 6c 65 73 20 61 |ar. DST| rules a|
|000002f0| 72 65 20 6d 61 67 69 63 | 0d 28 64 65 74 65 72 6d |re magic|.(determ|
|00000300| 69 6e 65 64 20 62 79 20 | 6c 6f 63 61 6c 20 6c 61 |ined by |local la|
|00000310| 77 29 20 61 6e 64 20 63 | 61 6e 20 63 68 61 6e 67 |w) and c|an chang|
|00000320| 65 20 66 72 6f 6d 20 79 | 65 61 72 20 74 6f 20 79 |e from y|ear to y|
|00000330| 65 61 72 2e 20 20 54 68 | 65 20 43 0d 6c 69 62 72 |ear. Th|e C.libr|
|00000340| 61 72 79 20 68 61 73 20 | 61 20 74 61 62 6c 65 20 |ary has |a table |
|00000350| 63 6f 6e 74 61 69 6e 69 | 6e 67 20 74 68 65 20 6c |containi|ng the l|
|00000360| 6f 63 61 6c 20 72 75 6c | 65 73 20 28 6f 66 74 65 |ocal rul|es (ofte|
|00000370| 6e 20 69 74 20 69 73 20 | 72 65 61 64 20 66 72 6f |n it is |read fro|
|00000380| 6d 0d 61 20 73 79 73 74 | 65 6d 20 66 69 6c 65 20 |m.a syst|em file |
|00000390| 66 6f 72 20 66 6c 65 78 | 69 62 69 6c 69 74 79 29 |for flex|ibility)|
|000003a0| 20 61 6e 64 20 69 73 20 | 74 68 65 20 6f 6e 6c 79 | and is |the only|
|000003b0| 20 73 6f 75 72 63 65 20 | 6f 66 20 54 72 75 65 20 | source |of True |
|000003c0| 57 69 73 64 6f 6d 0d 69 | 6e 20 74 68 69 73 20 72 |Wisdom.i|n this r|
|000003d0| 65 73 70 65 63 74 2e 0d | 0d 5c 69 74 65 6d 0d 54 |espect..|.\item.T|
|000003e0| 68 65 20 70 72 65 63 69 | 73 69 6f 6e 20 6f 66 20 |he preci|sion of |
|000003f0| 74 68 65 20 76 61 72 69 | 6f 75 73 20 72 65 61 6c |the vari|ous real|
|00000400| 2d 74 69 6d 65 20 66 75 | 6e 63 74 69 6f 6e 73 20 |-time fu|nctions |
|00000410| 6d 61 79 20 62 65 20 6c | 65 73 73 20 74 68 61 6e |may be l|ess than|
|00000420| 0d 73 75 67 67 65 73 74 | 65 64 20 62 79 20 74 68 |.suggest|ed by th|
|00000430| 65 20 75 6e 69 74 73 20 | 69 6e 20 77 68 69 63 68 |e units |in which|
|00000440| 20 74 68 65 69 72 20 76 | 61 6c 75 65 20 6f 72 20 | their v|alue or |
|00000450| 61 72 67 75 6d 65 6e 74 | 20 69 73 20 65 78 70 72 |argument| is expr|
|00000460| 65 73 73 65 64 2e 0d 45 | 2e 67 2e 20 6f 6e 20 6d |essed..E|.g. on m|
|00000470| 6f 73 74 20 55 4e 49 58 | 20 73 79 73 74 65 6d 73 |ost UNIX| systems|
|00000480| 2c 20 74 68 65 20 63 6c | 6f 63 6b 20 60 60 74 69 |, the cl|ock ``ti|
|00000490| 63 6b 73 27 27 20 6f 6e | 6c 79 20 65 76 65 72 79 |cks'' on|ly every|
|000004a0| 20 31 2f 35 30 74 68 20 | 6f 72 0d 31 2f 31 30 30 | 1/50th |or.1/100|
|000004b0| 74 68 20 6f 66 20 61 20 | 73 65 63 6f 6e 64 2c 20 |th of a |second, |
|000004c0| 61 6e 64 20 6f 6e 20 74 | 68 65 20 4d 61 63 2c 20 |and on t|he Mac, |
|000004d0| 69 74 20 74 69 63 6b 73 | 20 36 30 20 74 69 6d 65 |it ticks| 60 time|
|000004e0| 73 20 61 20 73 65 63 6f | 6e 64 2e 0d 0d 5c 65 6e |s a seco|nd...\en|
|000004f0| 64 7b 69 74 65 6d 69 7a | 65 7d 0d 0d 46 75 6e 63 |d{itemiz|e}..Func|
|00000500| 74 69 6f 6e 73 20 61 6e | 64 20 64 61 74 61 20 69 |tions an|d data i|
|00000510| 74 65 6d 73 20 61 72 65 | 3a 0d 0d 5c 72 65 6e 65 |tems are|:..\rene|
|00000520| 77 63 6f 6d 6d 61 6e 64 | 7b 5c 69 6e 64 65 78 73 |wcommand|{\indexs|
|00000530| 75 62 69 74 65 6d 7d 7b | 28 69 6e 20 6d 6f 64 75 |ubitem}{|(in modu|
|00000540| 6c 65 20 74 69 6d 65 29 | 7d 0d 0d 5c 62 65 67 69 |le time)|}..\begi|
|00000550| 6e 7b 64 61 74 61 64 65 | 73 63 7d 7b 61 6c 74 7a |n{datade|sc}{altz|
|00000560| 6f 6e 65 7d 0d 54 68 65 | 20 6f 66 66 73 65 74 20 |one}.The| offset |
|00000570| 6f 66 20 74 68 65 20 6c | 6f 63 61 6c 20 44 53 54 |of the l|ocal DST|
|00000580| 20 74 69 6d 65 7a 6f 6e | 65 2c 20 69 6e 20 73 65 | timezon|e, in se|
|00000590| 63 6f 6e 64 73 20 77 65 | 73 74 20 6f 66 20 74 68 |conds we|st of th|
|000005a0| 65 20 30 74 68 0d 6d 65 | 72 69 64 69 61 6e 2c 20 |e 0th.me|ridian, |
|000005b0| 69 66 20 6f 6e 65 20 69 | 73 20 64 65 66 69 6e 65 |if one i|s define|
|000005c0| 64 2e 20 20 4f 6e 6c 79 | 20 75 73 65 20 74 68 69 |d. Only| use thi|
|000005d0| 73 20 69 66 20 5c 63 6f | 64 65 7b 64 61 79 6c 69 |s if \co|de{dayli|
|000005e0| 67 68 74 7d 20 69 73 0d | 6e 6f 6e 7a 65 72 6f 2e |ght} is.|nonzero.|
|000005f0| 0d 5c 65 6e 64 7b 64 61 | 74 61 64 65 73 63 7d 0d |.\end{da|tadesc}.|
|00000600| 0d 0d 5c 62 65 67 69 6e | 7b 66 75 6e 63 64 65 73 |..\begin|{funcdes|
|00000610| 63 7d 7b 61 73 63 74 69 | 6d 65 7d 7b 74 75 70 6c |c}{ascti|me}{tupl|
|00000620| 65 7d 0d 43 6f 6e 76 65 | 72 74 20 61 20 74 75 70 |e}.Conve|rt a tup|
|00000630| 6c 65 20 72 65 70 72 65 | 73 65 6e 74 69 6e 67 20 |le repre|senting |
|00000640| 61 20 74 69 6d 65 20 61 | 73 20 72 65 74 75 72 6e |a time a|s return|
|00000650| 65 64 20 62 79 20 5c 63 | 6f 64 65 7b 67 6d 74 69 |ed by \c|ode{gmti|
|00000660| 6d 65 28 29 7d 20 6f 72 | 0d 5c 63 6f 64 65 7b 6c |me()} or|.\code{l|
|00000670| 6f 63 61 6c 74 69 6d 65 | 28 29 7d 20 74 6f 20 61 |ocaltime|()} to a|
|00000680| 20 32 34 2d 63 68 61 72 | 61 63 74 65 72 20 73 74 | 24-char|acter st|
|00000690| 72 69 6e 67 20 6f 66 20 | 74 68 65 20 66 6f 6c 6c |ring of |the foll|
|000006a0| 6f 77 69 6e 67 20 66 6f | 72 6d 3a 0d 5c 63 6f 64 |owing fo|rm:.\cod|
|000006b0| 65 7b 27 53 75 6e 20 4a | 75 6e 20 32 30 20 32 33 |e{'Sun J|un 20 23|
|000006c0| 3a 32 31 3a 30 35 20 31 | 39 39 33 27 7d 2e 20 20 |:21:05 1|993'}. |
|000006d0| 4e 6f 74 65 3a 20 75 6e | 6c 69 6b 65 20 74 68 65 |Note: un|like the|
|000006e0| 20 43 20 66 75 6e 63 74 | 69 6f 6e 20 6f 66 0d 74 | C funct|ion of.t|
|000006f0| 68 65 20 73 61 6d 65 20 | 6e 61 6d 65 2c 20 74 68 |he same |name, th|
|00000700| 65 72 65 20 69 73 20 6e | 6f 20 74 72 61 69 6c 69 |ere is n|o traili|
|00000710| 6e 67 20 6e 65 77 6c 69 | 6e 65 2e 0d 5c 65 6e 64 |ng newli|ne..\end|
|00000720| 7b 66 75 6e 63 64 65 73 | 63 7d 0d 0d 0d 5c 62 65 |{funcdes|c}...\be|
|00000730| 67 69 6e 7b 66 75 6e 63 | 64 65 73 63 7d 7b 63 6c |gin{func|desc}{cl|
|00000740| 6f 63 6b 7d 7b 7d 0d 52 | 65 74 75 72 6e 20 74 68 |ock}{}.R|eturn th|
|00000750| 65 20 63 75 72 72 65 6e | 74 20 43 50 55 20 74 69 |e curren|t CPU ti|
|00000760| 6d 65 20 61 73 20 61 20 | 66 6c 6f 61 74 69 6e 67 |me as a |floating|
|00000770| 20 70 6f 69 6e 74 20 6e | 75 6d 62 65 72 20 65 78 | point n|umber ex|
|00000780| 70 72 65 73 73 65 64 20 | 69 6e 0d 73 65 63 6f 6e |pressed |in.secon|
|00000790| 64 73 2e 20 20 54 68 65 | 20 70 72 65 63 69 73 69 |ds. The| precisi|
|000007a0| 6f 6e 20 64 65 70 65 6e | 64 73 20 6f 6e 20 74 68 |on depen|ds on th|
|000007b0| 61 74 20 6f 66 20 74 68 | 65 20 43 20 66 75 6e 63 |at of th|e C func|
|000007c0| 74 69 6f 6e 20 62 79 20 | 74 68 65 20 73 61 6d 65 |tion by |the same|
|000007d0| 0d 6e 61 6d 65 2e 0d 5c | 65 6e 64 7b 66 75 6e 63 |.name..\|end{func|
|000007e0| 64 65 73 63 7d 0d 0d 0d | 5c 62 65 67 69 6e 7b 66 |desc}...|\begin{f|
|000007f0| 75 6e 63 64 65 73 63 7d | 7b 63 74 69 6d 65 7d 7b |uncdesc}|{ctime}{|
|00000800| 73 65 63 73 7d 0d 43 6f | 6e 76 65 72 74 20 61 20 |secs}.Co|nvert a |
|00000810| 74 69 6d 65 20 65 78 70 | 72 65 73 73 65 64 20 69 |time exp|ressed i|
|00000820| 6e 20 73 65 63 6f 6e 64 | 73 20 73 69 6e 63 65 20 |n second|s since |
|00000830| 74 68 65 20 65 70 6f 63 | 68 20 74 6f 20 61 20 73 |the epoc|h to a s|
|00000840| 74 72 69 6e 67 0d 72 65 | 70 72 65 73 65 6e 74 69 |tring.re|presenti|
|00000850| 6e 67 20 6c 6f 63 61 6c | 20 74 69 6d 65 2e 20 20 |ng local| time. |
|00000860| 5c 63 6f 64 65 7b 63 74 | 69 6d 65 28 74 29 7d 20 |\code{ct|ime(t)} |
|00000870| 69 73 20 65 71 75 69 76 | 61 6c 65 6e 74 20 74 6f |is equiv|alent to|
|00000880| 0d 5c 63 6f 64 65 7b 61 | 73 63 74 69 6d 65 28 6c |.\code{a|sctime(l|
|00000890| 6f 63 61 6c 74 69 6d 65 | 28 74 29 29 7d 2e 0d 5c |ocaltime|(t))}..\|
|000008a0| 65 6e 64 7b 66 75 6e 63 | 64 65 73 63 7d 0d 0d 5c |end{func|desc}..\|
|000008b0| 62 65 67 69 6e 7b 64 61 | 74 61 64 65 73 63 7d 7b |begin{da|tadesc}{|
|000008c0| 64 61 79 6c 69 67 68 74 | 7d 0d 4e 6f 6e 7a 65 72 |daylight|}.Nonzer|
|000008d0| 6f 20 69 66 20 61 20 44 | 53 54 20 74 69 6d 65 7a |o if a D|ST timez|
|000008e0| 6f 6e 65 20 69 73 20 64 | 65 66 69 6e 65 64 2e 0d |one is d|efined..|
|000008f0| 5c 65 6e 64 7b 64 61 74 | 61 64 65 73 63 7d 0d 0d |\end{dat|adesc}..|
|00000900| 5c 62 65 67 69 6e 7b 66 | 75 6e 63 64 65 73 63 7d |\begin{f|uncdesc}|
|00000910| 7b 67 6d 74 69 6d 65 7d | 7b 73 65 63 73 7d 0d 43 |{gmtime}|{secs}.C|
|00000920| 6f 6e 76 65 72 74 20 61 | 20 74 69 6d 65 20 65 78 |onvert a| time ex|
|00000930| 70 72 65 73 73 65 64 20 | 69 6e 20 73 65 63 6f 6e |pressed |in secon|
|00000940| 64 73 20 73 69 6e 63 65 | 20 74 68 65 20 65 70 6f |ds since| the epo|
|00000950| 63 68 20 74 6f 20 61 20 | 74 75 70 6c 65 20 6f 66 |ch to a |tuple of|
|00000960| 20 39 0d 69 6e 74 65 67 | 65 72 73 2c 20 69 6e 20 | 9.integ|ers, in |
|00000970| 55 54 43 3a 20 79 65 61 | 72 20 28 65 2e 67 2e 20 |UTC: yea|r (e.g. |
|00000980| 31 39 39 33 29 2c 20 6d | 6f 6e 74 68 20 28 31 2d |1993), m|onth (1-|
|00000990| 31 32 29 2c 20 64 61 79 | 20 28 31 2d 33 31 29 2c |12), day| (1-31),|
|000009a0| 20 68 6f 75 72 0d 28 30 | 2d 32 33 29 2c 20 6d 69 | hour.(0|-23), mi|
|000009b0| 6e 75 74 65 20 28 30 2d | 35 39 29 2c 20 73 65 63 |nute (0-|59), sec|
|000009c0| 6f 6e 64 20 28 30 2d 35 | 39 29 2c 20 77 65 65 6b |ond (0-5|9), week|
|000009d0| 64 61 79 20 28 30 2d 36 | 2c 20 6d 6f 6e 64 61 79 |day (0-6|, monday|
|000009e0| 20 69 73 20 30 29 2c 0d | 6a 75 6c 69 61 6e 20 64 | is 0),.|julian d|
|000009f0| 61 79 20 28 31 2d 33 36 | 36 29 2c 20 64 73 74 20 |ay (1-36|6), dst |
|00000a00| 66 6c 61 67 20 28 61 6c | 77 61 79 73 20 7a 65 72 |flag (al|ways zer|
|00000a10| 6f 29 2e 20 20 46 72 61 | 63 74 69 6f 6e 73 20 6f |o). Fra|ctions o|
|00000a20| 66 20 61 20 73 65 63 6f | 6e 64 20 61 72 65 0d 69 |f a seco|nd are.i|
|00000a30| 67 6e 6f 72 65 64 2e 20 | 20 4e 6f 74 65 20 73 75 |gnored. | Note su|
|00000a40| 62 74 6c 65 20 64 69 66 | 66 65 72 65 6e 63 65 73 |btle dif|ferences|
|00000a50| 20 77 69 74 68 20 74 68 | 65 20 43 20 66 75 6e 63 | with th|e C func|
|00000a60| 74 69 6f 6e 20 6f 66 20 | 74 68 69 73 20 6e 61 6d |tion of |this nam|
|00000a70| 65 2e 0d 5c 65 6e 64 7b | 66 75 6e 63 64 65 73 63 |e..\end{|funcdesc|
|00000a80| 7d 0d 0d 5c 62 65 67 69 | 6e 7b 66 75 6e 63 64 65 |}..\begi|n{funcde|
|00000a90| 73 63 7d 7b 6c 6f 63 61 | 6c 74 69 6d 65 7d 7b 73 |sc}{loca|ltime}{s|
|00000aa0| 65 63 73 7d 0d 4c 69 6b | 65 20 5c 63 6f 64 65 7b |ecs}.Lik|e \code{|
|00000ab0| 67 6d 74 69 6d 65 7d 20 | 62 75 74 20 63 6f 6e 76 |gmtime} |but conv|
|00000ac0| 65 72 74 73 20 74 6f 20 | 6c 6f 63 61 6c 20 74 69 |erts to |local ti|
|00000ad0| 6d 65 2e 20 20 54 68 65 | 20 64 73 74 20 66 6c 61 |me. The| dst fla|
|00000ae0| 67 20 69 73 20 73 65 74 | 0d 74 6f 20 31 20 77 68 |g is set|.to 1 wh|
|00000af0| 65 6e 20 44 53 54 20 61 | 70 70 6c 69 65 73 20 74 |en DST a|pplies t|
|00000b00| 6f 20 74 68 65 20 67 69 | 76 65 6e 20 74 69 6d 65 |o the gi|ven time|
|00000b10| 2e 0d 5c 65 6e 64 7b 66 | 75 6e 63 64 65 73 63 7d |..\end{f|uncdesc}|
|00000b20| 0d 0d 5c 62 65 67 69 6e | 7b 66 75 6e 63 64 65 73 |..\begin|{funcdes|
|00000b30| 63 7d 7b 6d 6b 74 69 6d | 65 7d 7b 74 75 70 6c 65 |c}{mktim|e}{tuple|
|00000b40| 7d 0d 54 68 69 73 20 69 | 73 20 74 68 65 20 69 6e |}.This i|s the in|
|00000b50| 76 65 72 73 65 20 66 75 | 6e 63 74 69 6f 6e 20 6f |verse fu|nction o|
|00000b60| 66 20 5c 63 6f 64 65 7b | 6c 6f 63 61 6c 74 69 6d |f \code{|localtim|
|00000b70| 65 7d 2e 20 20 49 74 73 | 20 61 72 67 75 6d 65 6e |e}. Its| argumen|
|00000b80| 74 20 69 73 20 74 68 65 | 0d 66 75 6c 6c 20 39 2d |t is the|.full 9-|
|00000b90| 74 75 70 6c 65 20 28 73 | 69 6e 63 65 20 74 68 65 |tuple (s|ince the|
|00000ba0| 20 64 73 74 20 66 6c 61 | 67 20 69 73 20 6e 65 65 | dst fla|g is nee|
|00000bb0| 64 65 64 29 2e 20 20 49 | 74 20 72 65 74 75 72 6e |ded). I|t return|
|00000bc0| 73 20 61 6e 20 69 6e 74 | 65 67 65 72 2e 0d 5c 65 |s an int|eger..\e|
|00000bd0| 6e 64 7b 66 75 6e 63 64 | 65 73 63 7d 0d 0d 5c 62 |nd{funcd|esc}..\b|
|00000be0| 65 67 69 6e 7b 66 75 6e | 63 64 65 73 63 7d 7b 73 |egin{fun|cdesc}{s|
|00000bf0| 6c 65 65 70 7d 7b 73 65 | 63 73 7d 0d 53 75 73 70 |leep}{se|cs}.Susp|
|00000c00| 65 6e 64 20 65 78 65 63 | 75 74 69 6f 6e 20 66 6f |end exec|ution fo|
|00000c10| 72 20 74 68 65 20 67 69 | 76 65 6e 20 6e 75 6d 62 |r the gi|ven numb|
|00000c20| 65 72 20 6f 66 20 73 65 | 63 6f 6e 64 73 2e 20 20 |er of se|conds. |
|00000c30| 54 68 65 20 61 72 67 75 | 6d 65 6e 74 20 6d 61 79 |The argu|ment may|
|00000c40| 0d 62 65 20 61 20 66 6c | 6f 61 74 69 6e 67 20 70 |.be a fl|oating p|
|00000c50| 6f 69 6e 74 20 6e 75 6d | 62 65 72 20 74 6f 20 69 |oint num|ber to i|
|00000c60| 6e 64 69 63 61 74 65 20 | 61 20 6d 6f 72 65 20 70 |ndicate |a more p|
|00000c70| 72 65 63 69 73 65 20 73 | 6c 65 65 70 20 74 69 6d |recise s|leep tim|
|00000c80| 65 2e 0d 5c 65 6e 64 7b | 66 75 6e 63 64 65 73 63 |e..\end{|funcdesc|
|00000c90| 7d 0d 0d 5c 62 65 67 69 | 6e 7b 66 75 6e 63 64 65 |}..\begi|n{funcde|
|00000ca0| 73 63 7d 7b 74 69 6d 65 | 7d 7b 7d 0d 52 65 74 75 |sc}{time|}{}.Retu|
|00000cb0| 72 6e 20 74 68 65 20 74 | 69 6d 65 20 61 73 20 61 |rn the t|ime as a|
|00000cc0| 20 66 6c 6f 61 74 69 6e | 67 20 70 6f 69 6e 74 20 | floatin|g point |
|00000cd0| 6e 75 6d 62 65 72 20 65 | 78 70 72 65 73 73 65 64 |number e|xpressed|
|00000ce0| 20 69 6e 20 73 65 63 6f | 6e 64 73 20 73 69 6e 63 | in seco|nds sinc|
|00000cf0| 65 0d 74 68 65 20 65 70 | 6f 63 68 2c 20 69 6e 20 |e.the ep|och, in |
|00000d00| 55 54 43 2e 20 20 4e 6f | 74 65 20 74 68 61 74 20 |UTC. No|te that |
|00000d10| 65 76 65 6e 20 74 68 6f | 75 67 68 20 74 68 65 20 |even tho|ugh the |
|00000d20| 74 69 6d 65 20 69 73 20 | 61 6c 77 61 79 73 20 72 |time is |always r|
|00000d30| 65 74 75 72 6e 65 64 0d | 61 73 20 61 20 66 6c 6f |eturned.|as a flo|
|00000d40| 61 74 69 6e 67 20 70 6f | 69 6e 74 20 6e 75 6d 62 |ating po|int numb|
|00000d50| 65 72 2c 20 6e 6f 74 20 | 61 6c 6c 20 73 79 73 74 |er, not |all syst|
|00000d60| 65 6d 73 20 70 72 6f 76 | 69 64 65 20 74 69 6d 65 |ems prov|ide time|
|00000d70| 20 77 69 74 68 20 61 20 | 62 65 74 74 65 72 0d 70 | with a |better.p|
|00000d80| 72 65 63 69 73 69 6f 6e | 20 74 68 61 6e 20 31 20 |recision| than 1 |
|00000d90| 73 65 63 6f 6e 64 2e 0d | 5c 65 6e 64 7b 66 75 6e |second..|\end{fun|
|00000da0| 63 64 65 73 63 7d 0d 0d | 5c 62 65 67 69 6e 7b 64 |cdesc}..|\begin{d|
|00000db0| 61 74 61 64 65 73 63 7d | 7b 74 69 6d 65 7a 6f 6e |atadesc}|{timezon|
|00000dc0| 65 7d 0d 54 68 65 20 6f | 66 66 73 65 74 20 6f 66 |e}.The o|ffset of|
|00000dd0| 20 74 68 65 20 6c 6f 63 | 61 6c 20 28 6e 6f 6e 2d | the loc|al (non-|
|00000de0| 44 53 54 29 20 74 69 6d | 65 7a 6f 6e 65 2c 20 69 |DST) tim|ezone, i|
|00000df0| 6e 20 73 65 63 6f 6e 64 | 73 20 77 65 73 74 20 6f |n second|s west o|
|00000e00| 66 20 74 68 65 20 30 74 | 68 0d 6d 65 72 69 64 69 |f the 0t|h.meridi|
|00000e10| 61 6e 20 28 69 2e 65 2e | 20 6e 65 67 61 74 69 76 |an (i.e.| negativ|
|00000e20| 65 20 69 6e 20 6d 6f 73 | 74 20 6f 66 20 57 65 73 |e in mos|t of Wes|
|00000e30| 74 65 72 6e 20 45 75 72 | 6f 70 65 2c 20 70 6f 73 |tern Eur|ope, pos|
|00000e40| 69 74 69 76 65 20 69 6e | 20 74 68 65 20 55 53 2c |itive in| the US,|
|00000e50| 0d 7a 65 72 6f 20 69 6e | 20 74 68 65 20 55 4b 29 |.zero in| the UK)|
|00000e60| 2e 0d 5c 65 6e 64 7b 64 | 61 74 61 64 65 73 63 7d |..\end{d|atadesc}|
|00000e70| 0d 0d 5c 62 65 67 69 6e | 7b 64 61 74 61 64 65 73 |..\begin|{datades|
|00000e80| 63 7d 7b 74 7a 6e 61 6d | 65 7d 0d 41 20 74 75 70 |c}{tznam|e}.A tup|
|00000e90| 6c 65 20 6f 66 20 74 77 | 6f 20 73 74 72 69 6e 67 |le of tw|o string|
|00000ea0| 73 3a 20 74 68 65 20 66 | 69 72 73 74 20 69 73 20 |s: the f|irst is |
|00000eb0| 74 68 65 20 6e 61 6d 65 | 20 6f 66 20 74 68 65 20 |the name| of the |
|00000ec0| 6c 6f 63 61 6c 20 6e 6f | 6e 2d 44 53 54 0d 74 69 |local no|n-DST.ti|
|00000ed0| 6d 65 7a 6f 6e 65 2c 20 | 74 68 65 20 73 65 63 6f |mezone, |the seco|
|00000ee0| 6e 64 20 69 73 20 74 68 | 65 20 6e 61 6d 65 20 6f |nd is th|e name o|
|00000ef0| 66 20 74 68 65 20 6c 6f | 63 61 6c 20 44 53 54 20 |f the lo|cal DST |
|00000f00| 74 69 6d 65 7a 6f 6e 65 | 2e 20 20 49 66 20 6e 6f |timezone|. If no|
|00000f10| 20 44 53 54 0d 74 69 6d | 65 7a 6f 6e 65 20 69 73 | DST.tim|ezone is|
|00000f20| 20 64 65 66 69 6e 65 64 | 2c 20 74 68 65 20 73 65 | defined|, the se|
|00000f30| 63 6f 6e 64 20 73 74 72 | 69 6e 67 20 73 68 6f 75 |cond str|ing shou|
|00000f40| 6c 64 20 6e 6f 74 20 62 | 65 20 75 73 65 64 2e 0d |ld not b|e used..|
|00000f50| 5c 65 6e 64 7b 64 61 74 | 61 64 65 73 63 7d 0d |\end{dat|adesc}. |
+--------+-------------------------+-------------------------+--------+--------+
